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This publication describes the facilities provided by the 
IBM System/36 Model 44 Programming System. 

The Model 44 Programming System consists of a FORTRAN 
compiler, an assembler, a supervisor, and system support 
programs. It provides FORTRAN and assembler language proc- 
essing and program execution, in a monitored environment, 
with automatic job-to-job transition, interruption handling, 
and input/output supervision. The system has facilities for 
the creation and maintenance of libraries and the manipula- 
tion of their contents. It also provides extensive job 
control and program segmentation capabilities for flexibili- 
ty and versatility in the preparation of programs for 
execution. 








PREFACE 



This publication describes the functions 
and capabilities of the IBM System/ 36 
Model 44 Programming System; it is intended 
as a guide in understanding the system's 
capabilities and planning for their use. 
In order to understand this publication, 
the reader should be familiar with basic 
data processing techniques and terminology, 
and with the functional characteristics of 
the Model 44, as described in the publica- 
tions 

IBM System/360 System Summary , Form A22- 

6810 

I BM System/360 Principles o f O peration , 

Form A22-6821 

IBM S ystem/ 36 Model 44: Functional Char - 
acteristics, Form A22-687 5 

Language specifications for the language 
processors that are contained in the Model 
44 Programming System are given in the 
publications : 



IBM Sy stem/ 3 60 FORTRAN IV Language , 
C28-6515 



Form 



IBM System/360 Model 44 Programming Sys- 
tem: Assembler Language , Form C28-6811 



Related literature on specific 
input/output devices, educational material, 
etc. , is described in the IBM System/360 
Bibliography , Form A22-6822. 



The first section of this publication is 
a survey of the basic concepts of the 
entire system. Subsequent sections discuss 
the operation of the supervisor and the 
system support programs. In addition, 
there is an appendix giving standard label 
formats and a glossary of terms. 

Detailed specifications on the use of 
this system will be provided in subsequent 
publications . 



This publication was prepared for production usinq an IFK computer to 
update the text and to control the page and line format. Page 
impressions for photo-offset printing were obtained from an IBM 1U03 
Printer using a special print chain. 

Copies of this and other IBM runlicatiois can be obtained through IBM 
Branch Offices. 

A form for readers' comments appears at the back of this publication. 

It may be mailed directly to IFK. Address any additional comments 

concerning this publication to the IBM Corporation, Department D39, 1271 
Avenue of trie Americas, dew York, N.Y., 10C20. 

© 1966 by International Business Machines Corporation 
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MACHINE CONFIGURATION 



The machine configuration required for 
use of the Model 4 4 Programming System is 
as follows: 

• IBM 2044 Processing Unit with its 



Cr\m o<~*1 



r>t-nv_ V , 



Storage Drive, and at least 32,768 
bytes of main storage. 

• One multiplexor channel (#5248) and/or 
one or two high-speed multiplexor 
channels (first: #4598; second: 
#4599) . 

• One IBM 2315 Disk Cartridge 

• One of the following input devices: 

IBM 1442 Model Nl Card Read-Punch 
IBM 2501 Model Bl or B2 Card Reader 
IBM 2520 Model Bl Card Read-Punch 
IBM 2540 Model 1 Card Read-Punch 
IBM 2401 or 24 02 Model 1> 2, 3, 4, 

5, or 6 Magnetic Tape Unit 
IBM 2 40 3 Model \. 2. 3, '4. 5, or 6 

Magnetic Tape Unit and Control 
IBM 2404 Model 1, I, or -* Mannetir 

Tape Unit and Control 

• One of the following output listing 
devices: 

IBM 1403 Model 2, 3, 7, or Nl 

Printer 
IBM 14 4 3 Model Nl Printer 
Any of the magnetic tape units 

listed above 

• One of the following output punching 
devices : 

IBM 14 42 Model N2 Punch 

IBM 2520 Model B2 or B3 Punch 

Any of the card read-punch units 

listed above 
Any of the magnetic tape units 

listed above 

Notes on configurations: 

1. In addition to the above requirements, 
the system supports the attachment of 



A second Single Disk Storage Drive 

(with 2315 Cartridge) 
IBM 2311 Disk Storage Drives (with 

IBM 1316 Disk Pack) 
Additional magnetic tape units (any 

of the models listed above) 



2. A system-residence 2315 Disk Cartridge 
can be created using the minimum 
machine configuration, provided the 
input device is a card reader. Assem- 
bly is not required in this procedure. 
However, if it is desired to assemble 
the IBM-supplied components of the 
system, two Single Disk Storage 
Drives, at least one magnetic tape 
unit, and 65,536 bytes of main storage 
are required. 



3. If more than 32,768 bytes of main 
storage are available, the system will 
take advantage of their availability. 



Thp Fortran compiler T^nvi\ r^ 0, that the 
2044 be equipped with the floating- 
point arithmetic feature (#4427). The 
assembler also requires this feature 
if it is desired to assemble floating- 
point constants. 



5. 



6. 



The user may modify the supervisor to 
include input/output routines for 
additional devices, provided these 
devices have start, device end, and 
channel end characteristics similar to 
those of the supported devices. These 
characteristics are detailed in IBM 
System/360 Principles of Operation , 



Form A22-6821, 
device manuals. 



and the appropriate 



The Read-Eackward feature of the 2400 
Series Magnetic Tape Units is not 
supported. 



Machine Configuration 



BASIC CONCEPTS 



The IBM System/360 Model 44 Programming 
System, like the computing system itself, 
is designed to meet the specific needs of 
the scientific user. The principal object- 
ives of the Model 44 system are to increase 
the throughput (i.e., the rate at which 
work is handled) performance of the comput- 
ing system and, at the same time, to 
relieve the programmer of much of the work 
involved in program preparation, so that he 
can concentrate on the problem-solving 
aspects of programming. 



SYSTEM COM PONENTS 

The system resides on an IBM 2315 Disk 
Cartridge mounted on the Model 44 Single 
Disk Storage Drive. It includes a supervi- 
sor, a set of support programs that perform 
system-related and utility functions, and 
two language processors: a full FORTRAN IV 
compiler and an assembler. It also 
includes two stand-alone (i.e., not Operat- 



or yinrten 



not resident on the 2315 Disk Cartridge: a 
program for constructing a system rppiipprp 
volume and a loader for loading system- 
produced programs that are in absolute form 
and are to be executed independently of 
system control. 



SUPERVISOR 

The supervisor controls the entire 
system and provides a common interface to 
all processing programs, including the FOR- 
TRAN compiler, the assembler, the system 
support programs, and user-written pro- 
grams. Specifically, the supervisor 

• Manages the use of system resources. 
A resource is any facility of the 
system required by a job and includes 
input/output devices, data sets (the 
term applied to the major unit of data 
handled by the system), and processing 
programs . 

• Loads the appropriate execution phases 
from the phase library (i.e., the 
library of programs in absolute form, 
ready for execution) . 



Handles all 
input/output 
input/output 
dures. The 
input/output 



standard label checking, 
requirements, and 
error recovery proce- 
programmer requests 
operations without ref- 
erence to a particular device type, so 
that he does not have to alter his 



source program when data sets are 
moved from one device to another. 

Services interruptions and passes con- 
trol to the appropriate system or user 
routine for interruption processing. 

Schedules channel use to effect over- 
lap of processing with input/output 
operations. 



Provides for communication 
console operator. 



with the 



The supervisor functions are described 
in greater detail later in this publica- 
tion. 



SYSTEM SUPPORT PROGRAMS 

The system support programs provide a 
wide range of capabilities for use by both 

• jnb ^ ^r t t ^ 1 Pr^c^'sor. JcL vjciiLx\^l 
statements provide the parameters that 
describe the program (s) to be executed 
and the resources required to do so. 
This program processes the job control 
statements and sets up the tables and 
communication areas necessary to exe- 
cute a particular program. The job 
control processor allocates 
input/output resources and provides 
data set maintenance functions. 

• Linkage Editor. The output produced 
by the compiler or assembler, called a 
module , is in relocatable form. This 
program edits the modules into abso- 
lute form, automatically combining 
these modules with modules from the 
module library (one of the system 
libraries) where necessary. Since the 
formats of compiler-produced modules 
and assembler-produced modules are the 
same, the linkage editor can combine 
modules from both sources. This 
facility permits preparation of a pro- 
gram from parts written in either 
language. 

• Utility Programs. These programs pro- 
vide data set transmission and exter- 
nal storage initialization and main- 
tenance functions. 

The system support programs are des- 
cribed in greater detail later in this 
publication. 
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LANGUAGE PROCESSORS 



System Construction 



The FORTRAN compiler translates programs 
written in the FORTRAN language to 
System/360 Model 44 relocatable object pro- 
gram modules. 

The FORTRAN language parallels that of 
mathematics and is a familiar tool in 
mathematics, science, and engineering. 
Variables and constants may be either 
fixed- or floating-point values in single 
or double precision. In addition to the 
capabilities of the language itself, there 
is a library of subroutines for performing 
common mathematical procedures such as 
finding square roots, trigonometric func- 
tions, logarithmic values, etc. The com- 
piler recognizes the subroutine require- 
ments and automatically supplies the link- 
ages to the subroutine. 

Detailed language specifications for the 
Model 4 4 FORTRAN language are given in IBM 
Sys tem/3 60 FORTRAN IV Langua ge, Form 
C28-6515. 



A stand-alone program is provided that 
constructs a system (on a 2315 Disk 
Cartridge) from absolute and relocatable 
decks containing the executable phases and 
the relocatable modules the installation 
elects to include in its system. Note that 
no reassembly of system components is nec- 
essary in this process. 

All of the announced support will be 
included in the decks as distributed by 
IBM. As part of the initial program load- 
ing (IPL) procedure, the operator may spec- 
ify alterations in the predefined device- 
channel configuration and unit functions. 

System Editin g 

The installation may edit the system, by 
an assembly process, to change or extend 
the machine configuration, change the unit 
functions, alter the default conditions for 
system options, incorporate installation 
functions, etc. 



The assembler translates System/360 
assembler language programs to relocatable 
object program modules. The assembler lan- 
guage consists of all System/360 Model 44 
instruction mnemonics, literals, and a set 
of assembler instructions that direct the 
assembly process. Detailed language speci- 
fications for the assembler language are 
given in IBM System/360 Model 44 Program- 
mi ng System: Assembler Language , Form 
C28-6811. 

The assembler language programmer may 
use instructions in his program that 
request functions from the supervisor. For 
example, an instruction to read, included 
in an assembler language program, is 
actually an instruction to the input/output 
procedures portion of the supervisor. 

In the case of a FORTRAN program, the 
compiler generates the instructions that 
interact directly with the supervisor. For 
example, a READ statement in a FORTRAN 
source program causes the compiler to gen- 
erate instructions for the supervisor. 



SYSTEM CONSTRUCTION AND EDITING 

Each system can be tailored to the 
specific system function requirements and 
input/output configuration of the installa- 
tion. The installation may modify the 
IBM-supplied configuration, deleting func- 
tions not required by the installation and 
adding installation-created functions and 
programs. Depending on the nature of the 
modifications desired, there are two meth- 
ods of creating a system residence volume: 
system construction and system editing. 



ABSOLUTE LOADER 

Programs that are to be executed 
independently of system control and support 
can be prepared as absolute decks by using 
the facilities of the system. The absolute 
loader, which is itself a stand-alone pro- 
gram, can then be used to load these 
absolute decks for execution. The absolute 
loader is discussed in greater detail later 
in this publication. 



SYSTEM HIGHLIGHTS 

The programming system for the Model 4 4 
is designed to give the user the combined 
benefits of efficiency, flexibility, and 
ease of use. 

For most applications, the programmer 
can state his processing requirements very 
simply, since most of the processings- 
options have a default condition that rep- 
resents the usual case; that is, in the 
absence of an option specification, the 
system performs in the manner most commonly 
required. At the same time, the options do 
exist that permit a wide range of flexibil- 
ity. 

Furthermore, the processing options are 
selected in statements that are supplied 
independently of the source language pro- 
gram itself, so that they can be varied 
from one run to the next without altering 
the source program. Thus, the programmer, 
within reasonable limits, can build and 
test his program without regard to the 
conditions under which it is finally to be 



executed and can, in fact, vary these 
conditions from execution to execution. 



JOB PROCESSING 

The system provides for sequential job 
processing with automatic job-to-job and 
step-to-step transition. A job , which con- 



be combined 
later jobs. 



with other modules in 



sists of 



or mor« 
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as a unit of processing from the standpoint 

of installation accounting and operating 
system control. A job step is a unit of 
processing from the standpoint of the pro- 
grammer. It involves a description, via 
job control statements, of the resources 
required by and the execution of an expli- 
citly defined program. 

The job steps in a job need not be 
related. However, the system considers 
them to be interdependent to the extent 
that, if a job step fails in execution, the 
entire job is terminated. Furthermore, 
certain specifications may be made to 
extend over all or selected sequences of 
the job steps within the job. 

The possible combinations of job steps 
that make up a single job permit great 
flexibility in the preparation of programs = 
The simplest application would involve exe- 
cuting a program already in the phase 
iiorary. Another simple application, done 
in three job steps, is to compile (or 
assemble) a program into a relocatable 
module, edit the module into absolute form, 
called a program phase , and load and exe- 
cute the absolute phase. The intermediate 
step, editing, is done by the linkage 
editor. The linkage editor can also edit 
several relocatable modules together, auto- 
matically adding required modules from the 
module library, resolving symbolic cross- 
references among them, and producing a 
single absolute phase. A more complex 
application might consist of several 
compilation and/or assembly steps, an edit- 
ing step that combines their output modules 
(and perhaps library modules and modules 
that were assembled or compiled in a pre- 
vious job) into one or more absolute phas- 
es, and an execution of one or more of 
these phases. 

The programmer may retain his program 
(or parts of his program) in its relocata- 
ble and/or absolute form in direct access 
storage or on magnetic tape or cards. The 
full range of job processing options for a 
sequence of related job steps is described 
below. Within one job there may be several 
such sequences that are logically independ- 
ent of one another. 

• Compile (or assemble) only — useful 
when debugging a program or when 
creating a program module that is to 



Compile (one or more) and edit, or 
edit only — useful again in debug- 
ging, to ensure that all cross- 
references between modules are correct 
and/or to retain a program in absolute 
form. Note that a job can consist of 
a single editing step, editing 
relocatable modules from previous 



Compile (one or more) , edit, and exe- 
cute, or edit and execute, or execute 
only. Note that a job can consist of 
a single execution step, executing a 
program that was edited into absolute 
form in a previous job. 



DATA MANAGEMENT 

Setting up the mechanics of data and 
program storage and retrieval occupies a 
large percentage of programming time and 
effort. The system provides the programmer 
with several aids that reduce this time and 
effort both by simplifying the procedures 
and by eliminating the redundant effort and 
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ciated with repeated use of data or pro- 
grams . 

Specifically, the system has facilities 
for systematically creating, manipulating, 
and keeping track of data sets . A data set 
is defined as a named collection of data. 
The definition of a data set is solely in 
terms of its name; the definition is com- 
pletely independent of its data content or 
the way in which that data will be proc- 
essed. Moreover, a data set is defined 
externally of any processing program. 

Within a processing program, the pro- 
grammer expresses his input/output require- 
ments in terms of a symbolic data set name. 
That is, just as he manipulates symbols 
that represent variables with values to be 
supplied later, he specifies input/output 
operations on a symbolic data set. The 
relationship between a symbolic data set 
and the data set whose data content is to 
be processed is established at the time the 
processing program is executed. Thus, the 
actual data set that is processed may be 
varied from execution to execution without 
altering the processing program. 

In order for a data set to be used by 
the system, it must be identified to the 
system by both its name and its location. 
There are two ways of identifying a data 
set to the system. One is called catalog- 
ing. The catalog is itself a data set that 
the system uses in a special way. Each 
entry in the catalog contains a data set 
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name and an indication of its location. 
Catalog entries are made at the 
programmer's request. 



Once a data set has been cataloged, the 
programmer can refer to it by name without 
regard to its location- Since the catalog 
is a part of the system, a cataloged data 
set can be referred to and used indefinite- 
ly, by any number of jobs, until its entry 
is explicitly removed from the catalog. 

The physical location of a data set is 
entered in the catalog in terms of a volume 
identification, i.e., the installation's 
designation of the volume on which it 
resides. A volume is defined as all of 
that portion of a storage medium that is 
accessible at one time by a single 
read/write mechanism. Thus, a volume might 
be a 2315 Disk Cartridge, a 1316 Disk Pack, 
a reel of magnetic tape, or a card deck in 
a card reader hopper. 

If a data set is not cataloged, the 
programmer may still refer to it by name, 
but he must also supply the volume iden- 
tification in a job control statement with- 
in his job. The data set is then identifi- 
ed to the system for the duration of the 
job. 

The space on a volume occupied by a 
particular data set is called the extent of 
that data set. For a deck of cards or a 
reel of magnetic tape, it is not necessary 
for the programmer to define an extent for 
his data set, since only one data set at a 
time may occupy or reserve one of these 
volumes. For direct access storage 
volumes, however, the system must know the 
extent of each data set on the volume so 
that it can allocate space for new data 
sets, locate data sets already on the 
volume, etc. 

Each direct access volume carries a 
volu me table of contents (VTOC) x that iden- 
tifies each data set on the volume by name 
and extent. In creating a data set that is 
to reside on a direct access volume, the 
programmer must specify the anticipated 
size of the data set. When the system 
allocates space for the data set, it auto- 
matically makes an entry in the VTOC. 
Later references to that data set cause the 
system first to locate the volume (either 
from a catalog entry or from a job control 
statement giving the volume identification) 
and then to search the VTOC for the actual 
address of the data set. 



^-The VTOC is actually the collected data 
set labels for all data sets on that 
volume; see the Appendix for a description 
of these labels. 



Note that the space for a data set is 
allocated and named independently of any 
reading or writing of the data within it. 
Thus, the data set may be empty (i.e., the 
space is reserved for data) , partially full 
(with the potential for later additions) , 
or completely full. In addition, a data 
set may be completely rewritten, i.e., the 
data content may be completely replaced. 

Data Organiza t ion 

The facilities for creating data sets 
exist principally in the job control proc- 
essor. The user may organize his data set 
in one of two ways. The first of these, 
called sequential , is the familiar struc- 
ture in which records are placed in 
sequence. Given one record, the next 
record to be processed is uniquely deter- 
mined. The system processes all data sets 

(or members of a director ied data set; see 
below) sequentially. However, the program- 
mer may alter the sequence of processing 

(e.g. , for direct access applications) 
using input/output functions available in 
the system. 

In the second organization, called 
directoried , each data set is organized in 
two parts, a directory and members . The 
directory contains the name of each of the 
members, a pointer to the member's location 
in the data set, and the member's length. 
The members may be program modules or any 
other data. Directoried data sets must 
reside in direct access storage. The sys- 
tem uses the directory to locate individual 
members when they are required. 

Note that a symbolic data set can be 
related, via job control statements, to a 
specific member of a directoried data set, 
even though a member is not a data set, but 
only a part of one. A member has the 
characteristics of a sequential data set 
and the processing program is unaware that 
it is not a complete data set. 

When a member is created, it may be 
given more than one name and the multiple 
names are also listed in the directory. 
This enables the user to obtain the member 
using any one of several names. For exam- 
ple, consider the case of a member consist- 
ing of one subroutine that performs both 
sine and cosine evaluation. If it is 
listed in the directory under both SIN and 
COS, the programmer can call for the member 
by a name that is meaningful in the context 
of his program. 

The system provides facilities, via the 
job control processor and utility programs, 
for adding and deleting directoried data 
set members. The addition of a member to a 
directoried data set is always made start- 
ing at the end of the last member added. A 
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Figure 1. The Condensing Process 



deletion consists of simply removing the 
member entry from the directory. Thus, it 
is possible for a directoried data set to 
appear to be too full for a new addition 
even though sufficient space is actually 
available because of previous deletions. 
In these circumstances, the data set can be 
condensed . The condense function shifts 
the members in the data set to fill up 
vacant areas; the order of the members is 
not changed. Figure 1 illustrates the 
condensing process. 



Whichever organization is used for a 
particular data set, the following conven- 
tions apply: 



All data 
blocks. 



sets must have fixed-length 



2. More than one data set may occupy a 
direct access volume, but each data 



set must reside on contiguous tracks 
and cylinders. 

3. Tape reels may not contain more than 
one data set. 



LIBRARIES 

The system incorporates two directoried 
data sets that are permanently cataloged — 
the module library and the phase library. 

The module library contains relocatable 
program modules, produced by the compiler 
or assembler, and is a source of input for 
the linkage editor. The FORTRAN 
input/output conversion and mathematical 
subroutines are in this library. 

The phase library contains program phas- 
es that have been edited into absolute form 
by the linkage editor; this library is the 
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source from which programs are loaded for 
execution. The IBM-supplied processors 
reside permanently in this library. User- 
written programs may reside in this library 
either permanently or temporarily (i.e., 
for the duration of the job) . 

The presence of the phase library is 
essential to the operation of the svstem. 
Therefore, it resides on the 2315 Disk 
Cartridge designated as the system 
residence volume. The presence of the 
module library is optional and it need not 
reside on the system residence volume. 

As with any other directoried data sets, 
the programmer may make additions to and 
deletions from the libraries, condensing as 
necessary. Note, however, that all addi- 
tions to the phase library must be made via 
the linkage editor. 



EXTERNAL STORAGE ASSIGNMENT 

All references within a program to 
external storage are made in terms of 
symbolic data sets, which are in turn 
associated with symbolic unit names . The 
programmer uses job control statements to 
specify the assigning of a symbolic unit to 
an actual data set or member of a director- 
ied data set. 

The standard input/output device assign- 
ments and disk storage space allocation 
required by the system components and most 
problem programs are defined as data sets 
and associated with symbolic unit names 
during construction (or editing) of the 
system. The term for the predefined data 
set-symbolic unit relationships is system 
units. The programmer can use these data 
sets during his job by simply referring to 
them by their symbolic unit names; he need 
not be concerned with their type or wherea- 
bouts. Since these data sets are also used 
by the system components, they cannot be 



preserved from one job step to the next 
(with the exception of the print and punch 
output data sets) . 



If the programmer requires access to 
data sets whose symbolic unit assignments 
are not predefined, or if he needs to 
preserve data sets that are normally asso- 
ciated with system units, he may request 
the assignment of a symbolic unit to the 
desired data set (or member of a director- 
ied data set) . The volume and the location 
on the volume of the data set is either 
already known to the system (the data set 
already exists) , or the system is to allo- 
cate an extent and name it (the data set is 
to be created) . 

If the symbolic unit name is the same as 
one of the predefined system unit names, 
the effect is to redefine temporarily the 
data set assignment. For example, the 
normal source for system input might be the 
card reader; the programmer can temporarily 
reassign this function to a data set on a 
specific reel of magnetic tape and the 
system will then take his input from that 
data set. 

A symbolic unit can be associated with 
only one data set at a time, but different 
symbolic units can be assigned to the same 
data set at the same time. 

Requests for assignments are made in job 
control statements that are part of the job 
but independent of any job step within the 
job. In any case, within a job step the 
programmer can refer to all data sets (or 
members of a directoried data set) symboli- 
cally, so that he is not concerned with 
device addresses and disk space allocation 
when writing his program. 

Table 1 lists the predefined system 
units by symbolic name, data set name, 
function, and potential device type. 
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Table 1. System Unit Assignments 



r t 

Unit 

Name 



Data Set 
Name 



Function 



+- 



Permissible 
Devices 



SYSAB1 
SYSAB2 

SYSREL 

SYSLOG 

SYSRDR 

SYSIPT 

SYSLST 

SYSOPT 

o i. oPCxi 

SYSUAS 
SYSPSD 

SYSDMY 



SDSABS* 



SDSREL 



SDSLOG 



SDSRDR 



SDSIPT 



SDSLST 



SDSOPT 



iDuaf^n 



SDSUAS 



SDSPSD 



SYS000 



SYS001 



SYS002 



SDSCAT* 
SDSIPL* 



SDS000 



SDS001 



Phase library; used by program fetch and 

load routines. 
Phase library; used by linkage editor. 



Module library; used by linkage editor. 



Operator-system communication. 



Job control processor input. 



Processing program input; may be same as 
SYSRDR. 



System and diagnostic print output. 



Processor and user print output; may be same 
as SYSLST. 



Punch output, 



Job control unit assignment spill, 



Pseudo-directory to data set on SYS000: 

output from FORTRAN compiler, assembler; 
input to linkage editor. 



General system use. 



Catalog data set. 

Initializing routine for IPL procedure. 



Output from FORTRAN compiler, assembler; 
input to linkage editor. 

General system work data set; may be used 
by any processing program. 



Not used by system; available for assignment 
by programmer. 



Disk 



Disk 



Console Printer- 
Keyboard 



Card Reader 
Magnetic Tape 



Card Reader 
Magnetic Tape 



Printer 
Magnetic Tape 



Printer 

Maanetic Taoe 



Punch 
Magnetic Tape 



Disk 



Disk 



Disk 
Disk 



Disk 
Magnetic Tape 

Disk 
Magnetic Tape 

Any device 



SYS240 

J. X X X 

I * Must be on system residence volume (a 2315 Disk Cartridge). 
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SYSTEM 



Time at 



PROCESSING PROGRAM 



Device — 
Model 44 with 
Single Disk 
Storage Drive 



Volume — 
2315 Disk 
Cartridge 




control 
cessor, when 
to data set 
ested . 



By programmer, in 
assembler language 
source program, or 
by compiler, during 
compilation. 



During program execution, 
when input/output operations 
are performed on a data set. 



Symbolic 
Data Set 



*lf a data set is direcforied, the symbolic unit assignment can be to a specific member rather than to the 
entire data set, and the member is treated as a data set for the duration of the assignment. 



Figure 2. Data Management Relationships 



SUMMARY OF DATA MANAGEMENT RELATIONSHIPS 

Figure 2, using the 2315 Disk Cartridge 
as an example, illustrates the relation- 
ships involved in data management and the 
times at which they are established. 



DIRECT ACCESS STORAGE MANAGEMENT 

The system controls the disposition of 
all direct access storage space. In order 
to keep track of the space that is in use, 
the system creates a special label on each 
direct access volume as part of volume 
initialization. This label, called a for- 
mat 5 label , 3 - -indicates the extents of any 
space that is not occupied by a data set. 
Each time a data set is added to or deleted 
from a volume, the system automatically 
updates the format 5 label. 

All direct access storage space is allo- 
cated in units of a full track, starting at 



^This is a label designation of Operating 
System/360, which supports a volume label, 
five standard direct access storage data 
set labels, and the standard magnetic tape 
data set labels. Of these labels, the 
Model 44 system supports the creation and 
use of the volume, formats 1, 4, and 5, and 
the tape labels. Labels and label process- 
ing are discussed in the Appendix. 



a track boundary. If the programmer 
requests an amount that results in a par- 
tial track, the system automatically 
extends the amount to the next track bound- 
ary. 

The locations occupied by one data set 
must be contiguous in the volume. If there 
is sufficient space on a 2315 Disk Cart- 
ridge for a new data set but the space is 
not properly located (i.e., it is not 
contiguous) , the volume may be condensed in 
a manner similar to the condensing function 
available for directoried data sets. This 
function shifts the data sets on the volume 



xv^wctjl ncuitAj^: j_ r^\u 



horOfl 4--r-,^lr( 



-11CI K~ Cl-L *^ 



not in use. Once a disk volume has been 
condensed, all the available space starts 
at the end of the last data set and 
continues to the end of the volume. The 
system updates the format 5 label and all 
affected volume labels as part of the 
condensing process. 

Note that condensing a volume is a 
function of the utility processor, whereas 
condensing a directoried data set is a 
function of the job control processor. 

Since the system identifies a data set 
by its extent as well - as its name, any 
attempt to write beyond the extent is an 
error. Thus, if it is necessary to extend 
a data set beyond the boundaries initially 
set for it, the programmer must request 
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allocation of an entirely new area, large 
enough to contain his extended data set, 
and treat the data set as a new one. 



INPUT/OUTPUT FACILITIES 

The system provides two levels of 
input/output facilities to relieve the pro- 
grammer Oj_ tu€ n66u to prepare uxs own 
routines. At the higher level, called 

rpad/writp. -f-h*= r<rrtmrptmrT\f^r i RVOkfiS 
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tines that will execute the input/output 
operation. The lower level, called execute 
chan nel program , uses a combination of 
routines supplied by the programmer and the 
system. Assembler-language programmers 
invoke the input/output functions, at both 
levels, via an assembler- language calling 
sequence. The FORTRAN programmer is not 
concerned with either level, since his 
input/output requests are handled by the 
FORTRAN compiler. 

Use of the read/write level gives the 
assembler language programmer device inde- 
pendence. He can specify his input/output 
requirements without indicating a particu- 
lar device type or device address. This 
enables him to concentrate on the main 
elements of his program and also eliminates 
the need to revise programs when data sets 
are moved to diiterent devices. 

Device independence is made possible by 
the system's use of control blocks for each 
active symbolic data set. When a program 
calls for an input/output operation for a 
particular symbolic data set (by now asso- 
ciated, via the symbolic unit, with a 
particular data set) the system examines 
the current control blocks for that data 
set to determine which input/output rou- 
tines must be used. 

The system's execute channel program 
(EXCP) level is for programmers working 
with nonsupported devices and for those who 
wish to replace or supplement some of the 
system's routines with their own. 

Data Format 

The system works only with fixed-length 
data blocks. All blocks within a data set 
must be of the same length, although block 
lengths may vary among different data sets. 
The programmer is responsible for all 
blocking and unblocking of logical records 
within a block. 

Channel Overlap 

Input/output operations normally are 
overlapped with the main program's process- 
ing. A programmer can, however, suspend 
processing until an input/output operation 



has been completed and he has made sure the 
transmission was successful. In any case, 
the system always examines the last pre- 
vious operation that used a control block 
before starting another operation for the 
same control block. This examination is 
made each time the program calls for an 
input/output transmission. All unusual 
conditions are indicated to the program. 



fnntrnl Rlocks 



All communication between the problem 
program and data sets at the read/write 
level is through the system, which main- 
tains a request control block for each data 
set that is used. When the program calls 
for a read/write operation, the system 
examines the appropriate request control 
block for the data set for information 
about the device involved. It uses this 
information to determine which device- 
dependent routines are needed to satisfy 
the request. 

The request control block contains an 
input/output block that is the basic 
structure for communication between the 
system and the channel scheduler. The 
channel scheduler is a set of routines that 
keep track of the requests for use of 
devices on each channel and actually ini- 
tiate the input/output transmission. 

Request control blocks are allocated 
main storage space and are partially filled 
out by the programmer; the system completes 
the control information in the block during 
program execution. 



Execute Channel Program (EXCP) 

The execute channel program (EXCP) level 
of the system enables a programmer to work 
with devices not supported by the system, 
provided they transmit acceptable channel 
end, device end, and control unit end 
signals. The EXCP level also enables a 
programmer to replace or supplement some 
system routines with his own. 

The EXCP level schedules input/output 
requests, starts command execution, directs 
interruption handling, and restarts channel 
activity, when necessary. An EXCP program- 
mer must be familiar with the system's 
control blocks and must provide a channel 
program and an interruption analysis rou- 
tine for each request he issues. 

Interruption analysis routines are 
device-dependent routines that maintain the 
status of an operation, examine the results 
of an interruption for errors or unusual 
conditions, and initiate any necessary 
error recovery procedures. 
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The EXCP programmer must construct an 
input/output block for the system to use in 
order to communicate with the channel 
scheduler. He also must be familiar with 
the unit control block for each device he 
uses. This block reflects the current 
status of the device. 

The system's EXCP scheduler examines 
input/output requests to ensure that they 
are properly constructed. An invalid 
request causes abnormal termination of the 
operation. The scheduler also checks to 
see whether there is room for the request- 
in the channel queue and whether the chan- 
nel and device are available. If the queue 
is full, the request is reissued until it 
is accepted, and control returns to the 
calling program. The request is executed 
as soon as the device and channel are free 
and previous requests for the same facili- 
ties have been satisfied. 



DUMP FACILITIES 

The system 
facilities: 



provides two types of dump 



The programmer can specify in his job 
control statements that, in the event 
of an abnormal termination (e.g., one 
that results from a program check 
interruption) , the system is to pro- 
duce a hexadecimal dump before pro- 
ceeding to the next job. 

The console operator can also 
request this dump when he terminates a 
job with a cancel command (see 
"Operator-System Communication"). 

The subroutines DUMP and PDUMP, which 
reside in the module library, can be 
linkage-edited into the program and 
called by source program statements. 
These subroutines provide for dumping 
programmer— specif ieu. areas of main 
storage with the following format 
options: hexadecimal, integer, real, 
logical, complex, and literal. 

The DUMP routine causes the job to 
terminate after the dump is taken; the 
PDUMP routine returns control to the 
calling program and processing is 
resumed. 



SOURCE LANGUAGE INPUT 

Input to the FORTRAN compiler may be in 
either Extended Binary-Coded-Decimal Inter- 
change Code (EBCDIC) or Binary-Coded- 
Decimal Interchange Code (BCDIC) , but the 
codes cannot be mixed in the input for any 
one job step. 



Input to the rest of the system (i.e., 
the assembler language statements, job 
control statements, linkage editor control 
statements, utility control statements) 
must be in EBCDIC. 



COMPATIBILITY 

The Model 4 4 Programming System rep- 
resents a selected subset of the features 
available in the IBM System/360 programming 
support systems designed for the Models 30, 
40, 50, 65, and 75 -- specifically, 
System/360 Operating System (OS/360) , 
System/360 Disk Operating System (DOS/360), 
System/360 Tape Operating System (TOS/360) , 
and System/360 Basic Operating System 
(BOS/360). 1 Thus, there are certain areas 
of compatibility and interchangeability 
among these systems, as described below. 

Source Languages 

Source programs written in the Model 4 4 
FORTRAN language can, without modification, 
be compiled by the OS/ 360 FORTRAN IV com- 
piler for execution under control of 
OS/360. This also applies to DOS/360, 
TOS/360, and BOS/360, provided that the 
source program observes the language level 
supported by those systems. 

Source programs written in the Model 4 4 
assembler language can be assembled, with 
little or no modification, by the OS/360, 
DOS/360, or TOS/360 assembler, provided 
that any source statements involving sub- 
routine linkages or supervisor functions 
are modified to the format specified for 
OS/360, DOS/360, or TOS/360, respectively, 
and that there are no statements using 
machine instructions peculiar to the Model 
44 or assembler instructions peculiar to 
the Model 44 assembler. The assembler 
language publication cited in the preface 
includes a detailed comparison of the fea- 
tures of the various assemblers. 

Data Sets and Volumes 

Removable volumes (2400 Series Magnetic 
Tape Reels, 1316 Disk Packs) are interchan- 
geable between the Model 44 using the Model 
44 system and other System/360 models using 
OS/360, DOS/360, TOS/360, or BOS/360, 
subject to the following conditions: 

All data sets to be read by the 
Model 44 system must have names of 
no more than eight characters, be 
of fixed block length, sequential 
organization, and contained in 



^Publications detailing these systems are 
listed in the IBM System/360 Bibliography , 
Form A22-6822. 



16 



single extents on single volumes. 
They may not contain any check- 
point records. 



Data sets produced at the read/write 
level of the Model 44 system can be read 
and updated at the highest level of OS/360, 
DOS/360, TOS/360, or BOS/360 if the user 
maintains their standard fixed— length (type 
F) or variable-length (type V) logical 
record formats within the blocks. 

A volume created by OS/360 can be read, 
updated, and written by the Model 44 sys- 
tem- 



A volume created by DOS/360, TOS/360, or 
BOS/3 60 can be read and updated by the 
Model 44 system, but no additional data 
sets may be written on it except where the 
format 5 label is up to date. These 
systems create a format 5 label (i.e.. 
reserves space for it) at the time of 
volume initialization, but do not maintain 
it. A Model 44 utility function, map, is 
available for updating the format 5 label. 



Labex formats 2 and 3 do not apply to 
the Model 44 system. If they are present 
on a volume, they will be ignored except by 
the MAP function. 
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THE SUPERVISOR 



The supervisor is that portion of the 
system that controls system operation; it 
also performs functions required in common 
by the various processing programs, includ- 
ing user-written programs. 

The routines that collectively make up 
the supervisor fall into two categories, 
re s ident and transient , defined by their 
use of main storage. As their name 
implies, the resident routines are always 
present in main storage and represent func- 
tions that are frequently used or that 
simply must be present for the system to 
operate at all. The functions provided by 
the resident supervisor include: 

Communication region 

Interruption handling 

Program fetch and program load 

Channel scheduler 

Input/output routines 

Resident input/output error recovery 

Timer services 

The transient routines, on the other 
hand, share a predefined area of main 
storage. They are loaded only when their 
functions are needed and overlay each other 
in the transient area. The major functions 
of the transient supervisor include: 

Input/output error recovery 
Operator communications 
Open, close functions 



COMM UNICATION REGION 

The communication region is an area 
within the resident supervisor main storage 
wherein the job control processor stores 
parameters to direct the system in process- 
ing the next job step. It provides for 
communication between the supervisor and a 
processing program, and among processing 
programs. Included in this area are option 
parameters, parameters describing the lim- 
its of main storage, the job name, etc. 

The job control processor is described 
in the section "System Support Programs. " 



INTERR UPTION HANDLING 

An interruption is an automatic transfer 
of control from any storage location to a 
predetermined storage location. It can be 
caused by either a program instruction or a 
machine condition. The supervisor automat- 
ically handles all interruptions so that 



the programmer need not be directly con- 
cerned with them. In most cases, after an 
interruption is handled, control is 
returned to the point of interruption as if 
no break had occurred in the instruction 
sequence. 

There are five kinds of interruptions, 
as follows: 

1. Supervisor call 

2. External 

3. Program check 

4. Machine check 

5. Input/output. 



1 

Interruption 



SUPERVISOR 




Load Old PSW 



PROGRAM 



Machine 
Check 



Wait State 
Entered 



(Problem Program State) 



(Supervisor State) 



'Return from a program check interruption is dependent on the type of 
interruption and whether the problem program has requested control . 



Figure 3. Flow of Control Between Supervi- 
sor and Problem Program During 
an Interruption 

Figure 3 illustrates the flow of control 
between the supervisor and a problem pro- 
gram during an interruption. Control is in 
the problem program initially. An inter- 
ruption occurs, the status of the program 
is saved in the old Program Status Word 



(PSW) , and control is transferred to the 
supervisor. Depending on the type and 
reason for the interruption, control is 
given to an appropriate handling routine. 
Upon completion of the routine, the program 
may be restore^ to its oriyinaj. coritai Lion 
(via an old PSW) . Control is normally 
given back to the problem program at the 
point where it was interrupted. If 
desired, the user may have control of 
certain types of program check and external 
interruptions . 



elapsed, provided this occurs during 
execution of the job step that set the 
timer. 

If the presence of the timer feature is 
not specified when the system is edited, 
all timer interruptions are ignored and 
control is returned immediately to the 



inter rurrted Droaram, 



PROGRAM CHECK INTERRUPTION 



SUPERVISOR CALL INTERRUPTION 

The supervisor call interruption is 
caused when the SVC instruction is execut- 
ed. The SVC (Supervisor Call) instruction 
provides communication between the problem 
program and the supervisor. Each SVC has a 
certain interruption code that indicates to 
the supervisor which interruption handling 
routine is to be executed. 

The interruption routine analyzes the 
code and gives control to another routine 
within the supervisor, such as the program 
fetch routine, for the actual handling of 
the interruption. 



An external interruption can be caused 
by the timer feature, or by. the operator 
pressing the console interrupt key, or by 
an external signal. Interrupt-key and 
external-signal interruptions are not sup- 
ported by the Model 44 system; control 
returns immediately to the point of inter- 
ruption. 

If a timer interruption occurs, control 
is given back to the interrupted program 
unless the user has provided an address of 
his own handling routine. When this is the 
case, control is transferred to the address 
specified. 

The T imer Feature 

The timer feature enables the supervisor 
to provide three functions : 

1. Maintain the time of day, to which the 
user can refer at any point within the 
execution of the problem program. 

2. Time-stamp the beginning and end of a 
job. This information can be used for 
accounting and can be incorporated in 
a job log. 

3. Enable the user to set the timer for a 
specified interval of time and to get 
control at a prespecified user's rou- 
tine after the time interval has 



A program check interruption is caused 
by unusual conditions encountered in the 
program (e.g., overflow). Each program can 
select which one of the following options 
is to be taken in the event of a program 
check interruption, except that the third 
option is not available for all types of 
program check interruptions. 

1. Cancel: The job being executed is 
terminated and a message to the opera- 
tor describes the cause of the termi- 
nation. 

2. Dump and cancel: In addition to a 
message, all registers, all Program 
Status Words, and the problem program 
area are printed in the system listing 
data ScL. Tilt job jls> then LeiiuiiiaLeu. 

3. Transfer to user routine: If the 
address of a subroutine is supplied by 
the user, the program-check interrup- 
tion routine will branch to that sub- 
routine when an appropriate interrup- 
tion occurs. The user routine can 
determine the cause of the interrup- 
tion and handle it accordingly. 



MACHINE CHECK INTERRUPTION 

A machine check interruption results 
from a machine malfunction. When such an 
interruption occurs, the supervisor will 
attempt to list the machine check old PSW, 
the date, the time of day, and the program 
identification on the Console Printer- 
Keyboard, and to store information in a 
special area for later analysis. It then 
places the system in the wait state. The 
system can be restarted only through an 
initial program loading procedure. 



INPUT/OUTPUT INTERRUPTIONS 

An input/output interruption can be 
caused by: 

1. Input/output completion (channel end). 
The channel has completed sending to a 
device the information needed to carry 
out an input/output operation. The 



The Supervisor 19 



channel is now available for another 
operation. 

2. Input/output attention. This results 
from pressing the request key of the 
Console Printer-Keyboard. 

3. Device available (device end) . A 
device that was busy or not ready is 
now available for use. 

4. Control unit available (control unit 
end) . A control unit that was busy is 
now available for use. 

When one of these conditions is detect- 
ed, control transfers to the channel 
scheduler. 



successful. An error recovery procedure is 
entered when an error or unusual condition 
is detected. Then, unless execution of 
additional commands is required to satisfy 
the request, control returns to the inter- 
rupted program. If further command execu- 
tion is needed, control returns to the 
channel scheduler. No other operation for 
the same device is initiated until this 
additional sequence is completed. 

Note that execute channel program (EXCP) 
programmers must suppxy tuexr own mterrup - 
tion handling routines. The system handles 
these functions for the read/write program- 
mer. 



INPUT/OUTPUT FUNCTIONS 



CHANNEL SCHEDULER 

The channel scheduler is a supervisor 
routine that keeps track of channel activi- 
ty and initiates the actual in^ut/out^ut 
transmissions . 

The channel scheduler deals only with 
queued requests. When a program calls for 
an input/output operation, the request is 
put in a queue with other pending requests 
for the same channel. The channel schedul- 
er determines when each will be executed. 
It examines the status of the requested 
facilities and the order in which the 
requests were received and schedules opera- 
tions to make the most efficient use of all 
available channel resources. 

The channel scheduler is device 
independent. It must know what device is 
requested and must keep track of whether 
that device is busy or available, but it is 
not concerned with the type of device. The 
channel scheduler examines the appropriate 
control block to determine whether a 
device-dependent initialization routine 
must be entered. The initialization rou- 
tine sets up the command or chain of 
commands needed to satisfy the request, if 
it has not been constructed previously. 
When its work is finished, it returns the 
address of the command list to the channel 
scheduler, which starts the transmission. 

When there is a channel end interruption 
without device end, the interruption han- 
dler gives control to the channel schedul- 
er, which examines the queue for requests 
for other devices. If such a request is 
pending, the operation is started. When 
the interruption handler gives control to 
the channel scheduler after a device end 
interruption, the channel scheduler passes 
control to a device-dependent interruption 
analysis routine- This routine examines 
data sent from the device and the channel 
to determine whether the transmission was 



This section contains a list of the 
input/output functions available to an 
assembler-language programmer; they are 
invoked by assembler- language calling 
sequences, A brief description of the 
function's purpose accompanies each entry. 
Note that in the function descriptions the 
term "data set" is used to mean both an 
entire data set and a member of a director- 
ied data set. 

The first group, resident input/output 
functions, includes the functions most com- 
monly used in a program, such as read and 
write. The supervisor routines required to 
execute these functions always are present 
in main storage. 

The second group, transient functions, 
includes the open and close operations. 
The routines for these functions are less 
frequently used in a program and are called 
into main storage only when actually need- 
ed. If a program uses more than one data 
set, time can be saved by grouping open 
functions together and close functions 
together so that these transient routines 
do not have to be recalled frequently. 



RESIDENT INPUT/OUTPUT FUNCTIONS 

The Read Function: The read function is 

used to 

area of 

include 

set up 

starting 

examines 

there wa 

previous 

there is 

tion is 

read is 



transmit data from a data set to an 
main storage. Its parameters 

the name of a request control block 

earlier by the program. Before 

any new operation, the system 

this block to determine whether 

s a permanent error in the last 

operation associated with it. If 

any unusual condition, an indica- 

returned to the program and the 

not started. 



The Write Function; The write function is 
used to transmit data from an area of main 
storage to a data set. The system makes 
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the same examinations and takes the same 
action in cases of permanent error as for 
the read function. 



whether the programmer is operating at 
read/write level or at the EXCP level. 



the 



The Check Function 



The check function is 

f hat an lnniif/nn+niif 



to determine 
operation has been completed before proc- 
essina resumes. 



The N ote 
used to 
terms of 
relative 
tion is 
the point 
functions 
data sets 



Function: 



The note function is 

determine the current position, in 
a block number, of a symbolic unit 
to its beginning. The note func- 
generally used in conjunction with 

function (see below). These two 
enable the programmer to process 

in a nonsequential manner. 



The Poin t Func tion: The point function is 
used to reposition a symbolic unit to a 
specified data block. The programmer spe- 
cifies the desired block by supplying its 
block number relative to the beginning of 
the data set (or member). Thus, an argu- 
ment of zero results in the symbolic unit 
being positioned at the beginning of the 
first data block. 

The Wr ite-End-of-File (WEF) Function: The 
WEF function is used to write an end-of- 



The Rewind Function' 



The tpwi rid function 
is used to rewind a magnetic tape volume to 
its load point or, on a direct access 
volumn, to position a symbolic unit to its 
first block. 

The Unload Function: The unload function 
is used to rewind and unload a magnetic 
tape volume or, on a direct access volumn, 
to position a symbolic unit to its first 
block. 

The above read/write-level functions 
make use of the following resident 
functions, which can be called directly by 
the EXCP-level programmer: 



The Close Function 



_ The close function, 
data set on magnetic 



when applied to a 

necessary end-of-file marks and trailer 
labels = This function also is used to 
indicate the disposition of a data set or 
volume (e.g., whether a magnetic tape reel 
should be unloaded, rewound, or left as it 
is. ) 



INPUT/OUTPUT ERROR RECOVERY 

Examinations for input/output errors and 
unusual conditions are made at three points 
for programs at the read/write level. 

The first is when a program calls for an 
input/output operation. The program's 
request is examined, and the operation is 
cancelled if errors are found. 

Another check is made immediately after 
the system initiates the physical opera- 
tion. The system makes certain the command 
has been accepted by the channel and device 
and that the operation has started proper- 
ly. Action is terminated if this examina- 
tion reveals program errors or a non- 
or>pr"Rt i ona 1 device. In some cases such as 
when the device has not finished execution 
of a previous command, control returns to 
the interrupted or calling program until 
the device is free and the system can 
reissue the command. 

The final check is made immediately 
after completion of the physical operation. 
At this time, the system examines data 
provided by the channel and the device. If 
the possibility of error or an unusual 
condition is indicated, the system normally 
issues another command that causes the 
device to provide additional, more detailed 
information. 



Progr am (EXCP) Func- Interruption Analysis Routines 



The Exe cute Channe l 
tion: The EXCP function is used by pro- 
grammers at the execute channel program 
level to initiate an input/output opera- 
tion. All control blocks and interruption 
analysis routines must be constructed 
before this function is invoked. 



The Wait Function: 



used to suspend all 

input/output operation is completed 



The wait function is 
processing until an 



TRANSIENT INPUT/OUTPUT FUNCTIONS 

The Open Function: The open function caus- 
es the system to validate labels and, if 
necessary, reposition symbolic units. All 
data sets should be opened, regardless of 



The examinations for unusual conditions 
at the completion of physical operations 
are made by the system's interruption 
analysis routines. When no errors are 
detected, these routines act mainly as 
record keepers, noting such data as the 
number of blocks read or written, and 
preparing the system for the next 
input/output operation for the data set. 

Interruption analysis and error recovery 
procedures differ according to the type of 
device. In some cases (e.g., a reader 
check), when an error condition can be 
removed by operator intervention, a message 
is written on the Console Printer-Keyboard. 
Normally, the system repeats the 
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input/output operation, a process that eli- 
minates the most common errors. No other 
operation is initiated for the device while 
the error recovery procedure is in pro- 
gress. If the error continues to appear 
and is classified as permanent, the system 
updates the count of permanent errors in 
the unit control block for the device. 
Unusual conditions are indicated to the 
program. 

Programmers at the EXCP level must han- 
dle their own interruption analysis and 
error recovery routines. The same channel 
and device data that the system uses is 
made available to these programmers in the 
input/output control block and the unit 
control block. Detailed information on 
this data and the conditions to be checked 
can be found in IBM System/360 Principle s 
of O p eration (section entitled "Termination 
of Input/Output Operations"), Form 
A22-6821, and the appropriate device manu- 
als. 



The organization of programs into multi- 
phase structures is discussed in "Linkage 
Editor. " 



OPERATOR-SYSTEM COMMUNICATION 

The supervisor provides for two-way com- 
munication between the operator and the 
system, via the Console Printer-Keyboard. 
Three types of communication are permitted: 

1. Messages to the operator. 

2. Operator response to requests for 
operator action. 

3. Operator- initiated commands to the 
system. 



MESSAGES TO OPERATOR AND RESPONSE 

Messages to the operator can be initiat- 
ed by the system or by the programmer's job 
(via the job control PAUSE and comments 
statements) . 



PROG RAM FETCH AND PROGRAM LOAD 

Any program that is to be executed under 
system control must reside in absolute form 
in the phase library. This includes the 
supervisor transient routines, the language 
processors, the system support programs, 
and all user-written programs. Within the 
library, programs are stored as phases. 
Each phase represents a segment of code 
that is to be loaded into main storage at 
one time. The phase may be an entire 
program, or a part of a multiphase program. 

The program fetch function loads a phase 
into main storage from the phase library 
and transfers control to the phase entry 
point, an absolute address specified at the 
time the phase was processed by the linkage 
editor. A fetch operation may be invoked 
automatically by the supervisor (e.g., when 
it is necessary to load a transient 
routine) or by the job control processor 
when it processes an EXEC (execute) state- 
ment, or explicitly by processing programs 
that are multiphase. 

The program load function also loads 
phases into main storage from the phase 
library, but it does not transfer control 
to the entry point. Instead, it returns 
control to the invoking program. The phase 
load address may be one of the parameters 
supplied when the load function is invoked, 
thus permitting the programmer to relocate 
a phase at load time. The load operation 
can be invoked explicitly by processing 
programs. This function allows the pro- 
grammer to load phases of nonexecutable 
code (e.g., tables). 



The messages may indicate that an opera- 
tor action (e.g., mounting a volume) or 
decision is required, or they may simply 
contain information (e.g., for a job log). 
In the first case, the system will suspend 
processing until the operator responds with 
an indication that the action or decision 
is complete. In the second case, process- 
ing continues without interruption. 



OPERATOR COMMANDS 

The operator may enter a command in any 
of the following instances: 

1. He has pressed the request key. 

2. The system has requested operator 
response and processing has been sus- 
pended. 

3. The job has requested operator 
response with a PAUSE statement and 
processing has been suspended. 

There are three types of operator com- 
mands: intervention, input /output, and 
information. Except for the intervention 
commands, the system will accept only com- 
mands that are entered between job steps. 

Interv e ntion Commands 

The intervention commands, which are 
accepted at any time and processed immedi- 
ately, provide two functions: 

1. Immediately cancel the job currently 
in execution and proceed to the next 
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job. The operator may request a dump 
in the cancellation command and the 
system will produce a hexadecimal dump 
before proceeding to the next job. 

2. Cause the job control processor to 
pause at the end of the job step 
currently in execution. This allows 
the issuing of other operator commands 
at a time when they can be accepted. 

Input/O utput Comma nds 

The input/output commands provide the 
following functions: 

1. Assign a symbolic unit to a physical 
input/output device. 

2. Indicate that a device is temporarily 
unavailable to the system. 

3. Indicate that a device, detached as in 
item 2, has been restored to availabi- 
lity status. 

The following input/output commands per- 
mit temporary alteration of the machine 
configuration (until the next IPL) . They 
may be issued only as part of an IPL 



Indicate the addition of 
the machine configuration. 



devi r"e to 



5. 



Indicate the deletion of a device from 
the machine configuration. 



Information Commands 

The information commands provide the 
following functions: 

1. T.i st. the incut /out nut assignments cur- 
rently in effect. 

2. Initialize the date and time of day. 

3. Indicate the end of operator commands 
so thdt the system can proceed to the 
next job step. 



INITIAL PROGRAM LOADING (IPL) PROCEDURE 



Operation of the Model 4 4 system is 
initiated through an initial program load- 
ing (IPL) procedure. An IPL procedure is 
required whenever it is necessary to load 
or reload the system. 

The IPL procedure loads the resident 
portion of the supervisor and the job 
control processor and opens the data sets 
associated with system units. Control is 

this time, the system will pause and the 
opprat^r iT'tist <^et the date and thp tirp 13 ef 
day. He may also enter any other operator 
commands required before signalling the 
system to proceed. 
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SYSTEM SUPPORT PROGRAMS 



There are three processors, resident in 
the phase library, that are classified as 
system support programs. Two of these, the 
job control processor and the linkage edi- 
tor, are integral to the operation of the 
system. The third processor is a collec- 
tion of programs that provide utility func- 
tions under control of the system. 



the supervisor. At the end of the job 
step, the supervisor again loads the job 
control orocessor. 

The job control language is also used to 
call special functions of the job control 
processor that are not associated with a 
particular job step (e.g., condensing a 
directoried data set) . 



JOB CONTROL PROCESSOR 

The job control processor is loaded 
(originally during the initial program 
loading procedure and, thereafter, by the 
program fetch routine) between each job 
step. It then proceeds to read and inter- 
pret job control language statements from 
the system reader unit. 



The principal funct 
trol language is to 
to be done — the prog 
and the information 
From the information 
statements, the proc 
the supervisor, the 
program parameters, 
etc. , that define the 
step. 



ion of the job con- 
describe the job step 
ram to be executed 
required to do so. 
in the job control 
essor sets up, within 
input/output tables, 
communication words, 
requirements for this 



When all of the job control statements 
for this step have been processed, the 
processor returns control to the supervi- 
sor. The supervisor then fetches, from the 
phase library, the processing program asso- 
ciated with the step and loads it over the 
job control processor. Actual control of 
the step during execution is a function of 



JOB CONTROL LANGUAGE 

The statements in the job control lan- 
guage fall into four categories, as fol- 
lows: 

1. Job definition — define the program 
execution requirements (i.e., which 
programs and in what sequence) for the 
job. 

2. Symbolic unit assignment -- describe 
the data set and device resources the 
job will need during execution. 

3. Data set maintenance -- specify some 
action to be taken on a data set. 

4. Miscellaneous functions — specify 
comments, operator action pause, or 
repositioning a volume. 

The job control statements are grouped 
by category and summarized briefly in Table 
2. The double slash (//), the slash fol- 
lowed by an ampersand (/&) or an asterisk 
(/*) , or the asterisk alone (*) identify 
these statements as job control statements. 
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Table 2. Job Control Summary 



-n.xiji'ijji 



TTTIMri'TnM 



// 
// 

/g 
// 
/* 



JOB 
EXEC 



STOP 



JOB DEFINITION 
- T 

I 

| Defines the start of a job. 

| Defines the start of a job step execution and 
j the program to be executed. 
I Delimits the end of a job. 
j Delimits the end of all jobs. 

j Delimits the end of data in the input stream. 
.x 



SYMBOLIC UNIT ASSIGNMENT 



// ALLOC 
// LABEL 
// ACCESS 
// RESET 

// LISTIO 



Allocates space for a new data set. 
Defines characteristics of a data set. 
Permits access to an existing data set. 
Restores unit assignments to status at start 

of job. 
Lists data set and device assignments on 

system log. 



// DELETE 

// CONDENSE 
// RENAME 

// CATLG 
// UNCATLG 



DATA SET MAINTENANCE 



Deletes a data set from a volume or a member 

from a directoried data set. 
Condenses a directoried data set. 
Renames a data set or a member of a directoried 

data set. 
Enters a data set name into the catalog. 
Removes a data set name from the catalog. 



MISCELLANEOUS 



// PAUSE | Allows pause for operator action. 

* (comments) j Allows logging of comments to system log. 

// REWIND j Rewinds a tape volume; repositions a data set 

j on a direct access volume to beginning. 
// UNLOAD j Rewinds and unloads a tape. 
x 



Job Definition Statements 

The JOB Statement : The JOB statement is 
required for each job and must be the first 
card of the job deck. It supplies account- 
ing information to the installation 
accounting routine and indicates the start 
of the job control information for this 
job. 

The EXEC Statement ; The EXEC (execute) 
statement is required for each job step and 
must be the last job control statement 



before execution of a processing program. 
It indicates the end of control card infor- 
mation for a job step and that execution of 
the processing program for this step is to 
begin. The processing program named in an 
EXEC statement must reside in absolute form 
in the phase library. 



If the name field of the EXEC statement 
is blank, the preceding job step must have 
been an execution of the linkage editor. 
The system will then execute the program 
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phase (s) produced from that linkage editor 
job step. 

The EXEC statement is used to request 
that the operator set the variable- 
precision switch and to specify that a dump 
is to be taken in the event that the job 
step fails in execution. 

The EXEC statement also supplies any 
option parameters that are to be passed to 
the processing program. These include 
compiler and assembler options and can also 
be used by user-written programs. One of 
the options the user may specify in the 
EXEC statement for a compilation or assem- 
bly step is that the relocatable module 
produced by this step is to be linkage- 
edited later in this same job. The system 
will then direct the relocatable module to 
a data set where it can be immediately 
retrieved by the linkage editor. 

The EXEC statement may also include 
accounting information particular to this 
job step. 



Assign this data set to 
symbolic unit name. 



a particular 



6. 



Specify residence on a particular vol- 
ume or type of volume. 

Specify that the volume be "fresh," 
i.e., no other data set is currently 
resident on it. 

Indicate that the data set is to be 
directoried, and the desired size of 
the directory: the space will be allo- 
cated accordingly. The ACCESS state- 
ment (see below) is used to create 
individual members within the data 
set. 

Specify that the space allocated be 
rounded upward to the next higher 
cylinder boundary (rounding to the 
next higher track boundary is 
automatic) . 



7. Request that the data set be 
loged. 



cata- 



The End-of-Job Statement; The end-of-job 
(/S) statement is required for each job and 
must be the last card of the job deck. It 
initiates the post- job housekeeping that 
restores any system variables that were 
altered during the job. This includes 
resetting the system units, rewinding all 
tapes, clearing all pending interruptions, 
setting the interval timer, and posting 
final job accounting information. 

The STOP Statement; The STOP (end-of- jobs) 
statement is used to close all data sets 
associated with system units. If this 
statement is used, an IPL procedure is 
necessary to restart the system. 

The End-of-Data Statement; The end-of-data 
(/*) statement is required immediately 
following any input data on the system 
input unit when this unit is the same 
volume as the system reader unit. 

This statement is not actually read by 
the job control processor; instead, it is 
recognized as an end-of-file mark by what- 
ever processing program is currently read- 
ing the system input data set. 



S ymbolic Unit Assignment Statements 



The ALLOC Statement: 



The ALLOC (allocate) 
statement is used to create a data set; 
that is, to allocate space for it and name 
it. Within this statement the programmer 
can, if he desires: 



1. Give the data set 
eight characters. 



a name of up to 



From the information in the ALLOC state- 
ment, the system locates the desired vol- 
ume, allocates the space and, if the volume 
is a direct access one, updates the VTOC to 
reflect the creation of this data set. 

The ALLOC statement is required only 
when the programmer wishes to create a new 
data set. Once one has been created, 
subsequent jobs can gain access to it by 
using the data set name if it has been 
cataloged or the data set name and the 
volume identification if it has not been 
cataloged. 

If the data set has been assigned to a 
symbolic unit name, this assignment remains 
in force until either 

1. the assignment is redefined within the 
job (i.e., by an ALLOC or ACCESS 
statement) ; 

2. an applicable RESET is encountered 
(i.e., the unit named was one of the 
predefined system units) ; or 

3. the end of job is reached. 

The ACCESS Statement: The ACCESS statement 
is used to gain access to a data set that 
has been created by an ALLOC statement 
either previously in this job or in a prior 
job. This statement is also used to add a 
new member, assigning multiple names if 
desired, or refer to an existing member of 
a directoried data set. 

If the data set named in the ACCESS 
statement has been cataloged, then the name 
alone is sufficient to locate it. Other- 
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wise, the volume identification must be 
supplied in addition so that the system can 
locate the data set. 

Normally, when an existing data set is 
requested in an ACCESS statement and subse- 
quently opened, it is positioned at the 
beginning of the data set. If, however. 



progr; 



;h« 



to add to the data 



set, he can indicate this in his ACCESS 
statement and the data set will be posi- 
tioned at the end of the last entry made in 
the data set. 

Another ACCESS statement option allows 
the programmer to make references to a 
non-existent data set so that his program 
can operate without actually performing 
input/output operations on a data set. 
When this option is used, input/output 
requests for this data set are handled as 
follows: 

1. A read request results in an end of 

file. 

2. A write request is recognized but no 
data is transmitted. 

This option is useful not only in test- 
ing and debugging, but also for bypassing 
references to data sets used in regular 
procedures. For example, a new job that 
U£-.dat_cc jlTi cxutinu uio.ot.cL iucty ubt d. dummy 
master until the first detail data set is 
processed and the first master is produced. 

The ACCESS statement is required whenev- 
er a job step within the job: 

1. Uses a data set that was allocated in 
a previous job. 

2. Uses a data set that was allocated in 
this job, but the ALLOC statement did 
not give a symbolic unit assignment. 

3. Requires a redefinition of a current 
data set-symbolic unit assignment. 

4. Refers to a member of a directoried 
data set. 



Refers to 
exist. 



data set that does not 



The LABEL Statement: The LABEL statement 
follows immediately after an ALLOC state- 
ment or, for data sets on unlabeled tape 
volumes, an ACCESS statement. It further 
defines the characteristics of the data set 
named by the ALLOC or ACCESS. Within this 
statement, the programmer supplies the 
information from which the system will 
either generate the data set labels or, for 
an unlabeled tape data set, fill out the 
cont rol blocks . 



Labels and label processing are des- 
cribed in the Appendix. 

The RESET Statement: The RESET statement 
is used to restore either a selected one of 
the system unit assignments or all of them 
to their status at the beginning of the 
job. There is an implied RESET at the end 
of every job. 

The LISTIO Statement: The LISTIO (list 
input/output) statement causes the printing 
on the system log of either a selected one 
or all of the symbolic unit names and their 
current data set and device assignments. 

Data Set Maintenance Statements 

The DELETE Statement: The DELETE statement 
can be applied either to an entire data set 
or to a single member of a directoried data 
set. In the first case, the statement 
causes deletion of the VTOC entry for the 
named data set and the updating of the 
volume's format 5 label. If the data set 
is cataloged, its entry is also deleted 
from the catalog. In the second case, the 
data set member name is simply removed from 
the directory. If this member has multiple 
names in the directory, it is still acces- 
sible via the other namp(s). 



The 



CONDENSE 



Statement; 



The 



CONDENSE 



statement causes a directoried data set to 
be condensed. The condense function is 
described in the section "Data Organiza- 
tion. " 

The CATLG Statement: The CATLG (catalog) 
statement causes a data set entry to be 
added to the catalog. Since a cataloging 
option is also available in the ALLOC 
statement, this statement is necessary only 
when a data set has been created previously 
and it is now desired to catalog it. 



The 



UNCATLG Statement: The UNCATLG 

(uncatalog) statement causes a data set 
entry to be deleted from the catalog. The 
data set itself and the volume on which it 
resides are unchanged. 

The RENAME Statement: The RENAME statement 
can be used to rename either an entire data 
set or a member of a directoried data set. 
In the first case, the change is made in 
the VTOC; the catalog is also checked and, 
if an entry for the data set occurs in the 
catalog, the name is changed there as well. 
In the case of a member, the name is 
changed in the directory. No change is 
made to any other names for the same member 
that might occur in the directory. 

Miscellaneous Statements 

The PAUSE Statement: The PAUSE statement 
permits the programmer to specify a pause 
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in processing so that the console operator 
can take some action. The statement, which 
can include the programmer's instructions 
to the operator, is printed on the Console 
Printer-Keyboard and the machine then waits 
for the operator's signal to proceed. 

The Comments Statement: The comments (*) 
statement gives the programmer a convenient 
means of documenting his job. The contents 
of the comments statement will be printed 
on the Console Printer-Keyboard. This 
statement, when followed by a PAUSE state- 
ment, can also be used to specify operator 



action in the event that the programmer's 
directions do not fit within the limits of 
the PAUSE statement. 



The REWIND Statement : The REWIND statement 
is used either to rewind a tape volume or, 
on a direct access volume, to position a 
data set to its first block (block number 
0). 

The UNLOAD Stat ement: The UNLOAD statement 
is used to rewind and unload a specified 
reel of magnetic tape. 



Statement 



Comments 



H 



//JOBl 
//SYSOPT 



JOB 
ALLOC 



output data set, special unit 



// 

/* 
// 

// 
// 



V/SYS0 6 
//SYS005 



// 

// 

/& 

//JOB2 

//SYS008 

//SYS005 



EXEC assembler, link 
assembler language source deck 



RESET 

EXEC 
ALLOC 

LABEL 
ACCESS 

ACCESS 



CATLG 
EXEC 

JOB 
ACCESS 

ACCESS 



linkage editor 

data set 1, disk volume 10 

label information 
data set 1 (member la) 

data set 2, tape volume 20 



data set 2 



data set 1 (member la) , 

volume 10 
data set 2 



//SYS006 ALLOC 



// 


T 1\ DDT 


// 


ALLOC 


// 


LABEL 


// 


EXEC 



label information 

data set 4, disk volume 



label information 
program aa 



//SYS005 ACCESS data set 5 



data set 4 
SAVE SYS006 
program bb 



//SYS007 


ACCESS 


// 


PAUSE 


// 


EXEC 


// 


UNCATLG 



data set 53 



// 



STOP 
Sample Deck Setup 



disk 



data set 3, tape volume 21 
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Beginning of job JOBl. 

Give special assignment to system 

output unit 
Assemble following source deck. 
(SYSRDR and SYSIPT are the same.) 
End of source deck. 
Reset SYSOPT to standard 

assignment. 
Edit program just assembled. 
Data set 1 to be created on disk 

volume 10. 
Label information for data set 1. 
Set up to write member la of data 

set 1; unit assigned is SYS006. 
Set up to use data set 2 (allocated 

to tape volume 20 in a previous 

job) ; unit assigned is SYS005. 
Catalog data set 2. 
Execute the edited program. 
End of job JOBl. 
Beginning of job JOB2. 
Set up to use member la (written in 

JOBl); unit assigned is SYS008. 
Set up to use data set 2 (cataloged 

in JOBl) ; unit assigned 

is SYS005. 
Data set 3 to be created on tape 

volume 21. 
Label information for data set 3. 
Data set 4 to be created on disk 

volume 11 (will be written by 

program bb) . 
Label information for data set 4. 
Execute program aa from phase 

library. 
Reassign SYS005 and set up to use 

data set 5 (cataloged in a 

previous job) . 
Assign data set 4 to SYS007. 
Operator action pause. 
Execute program bb from phase 

library. 
Remove entry for data set 53 from 

catalog. 
End of job. 
End of jobs. 



Figure 4. 
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SAMPLE DECK SETUP 

Figure 4 illustrates a sample deck setup 
using the ALLOC and ACCESS statements for 
data set creating and symbolic unit assign- 
ment. Note that the statements in Figure 4 
are not complete • onl^' those parameters 
that are meaningful to the example have 
been included. The parenthetical remarks 
in the comments indicate assumptions that 
have been made for the purposes of this 
example. 



LINKAGE EDITOR 

Output from the compiler or the assem- 
bler is always in the form of relocatable 
object program modules. Each module con- 
sists of an external symbol dictionary, the 
text of the module (i.e., the instructions, 
in a relocatable format) , and a relocation 
dictionary. The text consists of one or 
more control sections, as specified in the 
assembler or FORTRAN source language pro- 
gram. A control section is defined as a 
unit of text that can be independently 
relocated. 

These modules must be processed by the 
linkage editor before they can be executed. 

tor is to convert the relocatable text into 

q }~) c; o 1 T) -t- <=» f nrif . rog ^v +" <~> hP ]oTip'i ?l1" ^ 

executed. The linkage editor includes 
facilities for linking together several 
control sections from one or more relocata- 
ble modules into one absolute executable 
program. The process of "linking" involves 
determining the absolute load addresses for 
each of the control sections and, from 
information in the external symbol dic- 
tionaries associated with the several 
modules, replacing symbolic cross- 
references between control sections with 
the absolute address of the referenced 
value. 

The facilities provided by the linkage 
editor permit the programmer to construct 
programs that are multiphase; this topic is 
discussed in "Program Structures." 



LINKAGE EDITOR PROCESSING 

The programmer may specify at the 
execution of one or more compilation or 
assembly steps that the linkage editor will 
be called later in the job to edit the 
relocatable modules produced by the compi- 
lation or assembly step(s). The modules 
will then be stored in a data set from 
which the linkage editor can immediately 
retrieve them. In addition, the programmer 
may specify, through linkage editor control 
statements, that other modules are to be 
included as well. Or he can set up a job 



without compilation or assembly steps and 
specify, again through linkage editor con- 
trol statements, that certain relocatable 
modules, produced in previous jobs, are to 
be edited together. 



linkage editor control statements and relo- 
catable object program modules. Generally 
speaking, the primary sources of linkage 
editor input are: 

1. The system unit that serves as inter- 
mediate storage for the relocatable 
modules as they are produced by the 
compiler or assembler. That is, this 
is the source of modules that were 
produced in job steps within this same 
job. 

2. The system input unit. Input from 
this source is first written on the 
system unit described in item 1 above. 
Thereafter, it is treated exactly as 
the other modules already on that 
unit. 

3. The module library, which contains 
frequently used subroutines, such as 
the FORTRAN mathematical subroutines. 
Input from this source is automatic; 
that is, no .Linkage eaitoi controi 
statements are necessary to indicate 

module library required by this pro- 
gram should be included. 

The output from the linkage editor is 
directed to the phase library. (A phase 
may be punched out as an absolute deck 
using the utility processor punch 
function. 1 ) The programmer can indicate in 
his linkage editor EXEC card that residence 
in the phase library is to be either 
temporary (for the duration of the job) or 
permanent (the program is available for 
execution at any time until explicitly 
deleted from the library) . 



PROGRAM STRUCTURES 

As discussed above, the input to the 
linkage editor is in units of modules. 
Output from the linkage editor is in units 
of phases. A phase is that portion of an 
absolute program that is to be loaded by a 
single program fetch or load operation. 
The phase may be an entire program or a 
part of a program. 



^-All entries in the phase library must be 
made by the linkage editor. Therefore, to 
enter an absolute deck into the phase 
library for execution under system control, 
the deck must be reprocessed by the linkage 
editor as if it were a relocatable module. 
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The simplest case is a single-phase 
program. However, the linkage editor per- 
mits the programmer to set up his program 
with an overlay structure wherein each 
phase is a part of the program that may be 
combined with or loaded over other phases 
during execution of the program. That is, 
after a phase is loaded and executed, the 
next phase may be loaded into the same area 
of main storage, overlaying the previous 
phase. Each phase has a programmer- 
specified origin and the phases are 
executed in a programmer-specified 
sequence. Thus, the programmer controls 
which parts of the program are to be 
overlaid and when. 



ment for a root phase. Programs may be 
structured into phases all of which origi- 
nate at SYSORG. 



LINKAGE EDITOR CONTROL STATEMENTS 

Following the EXEC statement specifying 
the linkage editor, the programmer uses 
linkage editor control statements to speci- 
fy which control sections are to be includ- 
ed, the phase structure, and the origin of 
each phase. The sequence of execution of 
the phases is determined by the fetch or 
load requests within his program. There 
are four of these statements, as follows: 



Note that there is no means of executing MODULE 
multiphase programs written solely in the 
FORTRAN language. However, the FORTRAN 
programmer can use the linkage editor to 
incorporate in his program assembler- 
language routines that will invoke the 
fetch operation for loading subsequent 
phases. 

Figure 5 illustrates the use of main 
storage by an overlay program- The loading 
sequence in Figure 5 is ROOTPH, Al, Bl, B2 
(overlaying Bl) , A2 (overlaying Al and B2) . 
Although this illustration shows a root 
phase (ROOTPH) as resident in main storage PHASE 
throughout execution, there is no require- 



Indicates that the sequence of 
cards or card images immediately 
following this statement on the 
system input unit consists of a 
relocatable module intended for 
inclusion in the linkage editor 
input . 

Any use of MODULE statements 
and their associated modules must 
precede any other linkage editor 
control statements in this job 
step. 

Defines a phase by providing the 
linkage editor with a phase name 





Supervisor 

Resident 


SYSORG 


Transient 


Phase: ROOTPH 




Phase: Al 


Phase: A2 




Phase: 


Bl 


Phase: B2 


SYSEND 


*.;•«.■..*> <v^<?;*4*&«^#>*:<&1** 
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Time 



Figure 5. Example of Use of Main Storage by an Overlay Program 
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(the member name to be entered in 
the directory of the phase 
library) and the origin of the 
phase. 

An option in this statement 



phase, the automatic 



linking to 



INCLUDE Identifies a particular module, 
or control section (s) within a 
module, for inclusion in a phase. 

ENTRY Defines the phase entry point. 
If ENTRY is omitted, the entry 
point is assumed to be the first 
entry name encountered in a 
module END card in the phase or, 
if none exists, the first loca- 
tion of the phase. 



UT ILITY PROGRAMS 

The utility programs fall into two cate- 
gories: volume initialization and main- 
tenance, and data set transmission. These 
programs are called by an EXEC statement 
specifying the utility processor, followed 
by a statement specifying the desired util- 
ity 1 unction. 



VOLUME UTILITIES 

There are three volume utility func- 
tions: 

In i tialize: Initializes a direct access 
volume or a tape volume, creating the 
standard labels as described in the appen- 
dix. 

If the volume being initialized is 
direct access, this function performs an 
analysis of the recording surface, checking 
for defective tracks. If a defective track 
is found, it is flagged, an alternate track 
is assigned, and the system thereafter uses 
the alternate track in place of the defec- 
tive one. 

If a volume should develop a defective 
track after initialization, a message is 



printed to the operator giving the number 
of the defective track. The volume can be 
partially initialized thereafter to accom- 
plish assignment of an alternate track. 
The contents of the defective track are 
lost. 



Map; 



Examines the VTOC of a direct access 



>lurae 



mat 5 label. No data set is deleted or 
moved, but a map of the volume is produced 
with the expired data sets flagged. 

Squeeze: Condenses a 2315 Disk Cartridge. 
This condensing operation is similar to 
that described for directoried data sets 
(see "Data Organization"). However, the 
squeeze function does not include condens- 
ing any directoried data sets that might be 
on that volume. The VTOC is updated but is 
not moved; the format 5 label is also 
updated. 



DATA SET TRANSMISSION UTILITIES 



There are four 
utility functions: 



data set transmission 



Copy: Reads a data set from a symbolic 
unit and writes it into a data set on 
another symbolic unit. The data set being 
copied may be written as a member of thp 



toried. Data sets may 
using the copy function. 



be reblocked by 



Print: 



Reads 



data set from a symbolic 
unit and writes it on the system printer 
unit. 



Punch : 



Reads 



a data set from a symbolic 

unit and writes it on the system punch 
unit. 

Print-punch: Reads a data set from a 
symbolic unit and writes it on both the 
system printer unit and the system punch 
unit. 

If the data set being copied, printed, 
or punched is directoried, the user can, if 
he desires, write a single member without 
its directory entry, or write one or more 
members with their directory entry. 
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ABSOLUTE LOADER 



The programmer may use the facilities of 
the system to prepare programs that are to 
be executed independently of system control 
and support. As described in the section 
on the linkage editor, the linkage editor 
output, which is in a form ready for 
execution, can be punched out on cards. 

Tho 1 inlrano oditnr nonrii +- c; -J-Vifi Rnpm'fi- 

cation of origins at any location, includ- 
ing below the upper limit of supervisor 
main storage. 



The absolute loader, which is itself 
independent of system control, can be used 
to load these decks for execution. The 
user is cautioned that none of the system 
facilities (e.g., input/output request 
handling) are available to his program 
during its execution, nor is there any 
protection against inadvertent destruction 
of the system residence volume, should it 
be mounted on-line. 
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APPENDIX. LABELS AND LABEL PROCESSING 



The use of standard labels enables the 
system to identify volumes and ensure that 
the correct volume is beinq used and that 
no current information is inadvertently 
destroyed. 



=> Lcmucii. u. 



t - u c i ~ •: 



_ ■> , , j „ 



xajjcia iiiuxuut; une vuimue 



label for each volume and one (direct 
access) or two (magnetic tape) data set 
labels for each data set on the volume. 



DIRECT ACCESS VOLUME LABELS 

All direct access storage volumes to be 
used in the environment of the Model 4 4 
Programming System must have certain stand- 
ard labels, as follows: 

Volume Label (Figure 6): Always the third 
record on cylinder 0, track 0, of a direct 
access volume, this label contains the 
volume identification and the address on 
the volume of the volume table of contents 
(VTOC) . 



TAPE VOLUME T.ABELS 

The installation can edit the system to 
specify that the tape volumes to be used 
with the system will not have standard 
labels. In this case, the system assumes 
that all tape volumes are unlabeled. 



If standard labeling is specified, the 
system expects all tape volumes to have 
standard labels. A tape that is found not 
to have standard labels is treated as 
unlabeled and no further attempt will be 
made to check labels on an input volume or 
write labels on an output volume. 



The standard tape volume labels are as 
follows: 



Volume Label (Figure 6) : This label is the 
first label on the tape and contains the 
volume identification. 



The VTOC contains all the data 
labels for the volume, as follows: 



set 



Format 1 Labels (Figure 7) : One for each 
data set on the volume, this label contains 
the data set name and other data pertinent 
to system identification and use of this 
data set. 

Format 4 Label (Figure 8): The first label 
in the VTOC, this label defines the VTOC 
itself. There is only one format 4 label 
on each volume. 



Header_ La bel ( Fi q urp lllJuL Following 

immediately after the volume label, this 
label provides the data set name and other 
data pertinent to system identification and 
use of this data set. 



Trailer Label (Figure 10) : Except for the 
label identification field, this label is 
the same as the header label and indicates 
the end of the data set. 



Format 5 Label (Figure 9) : 



Used for man- 
volume, this 



agement of the space on the 

label lists the extents of available space. 

The volume initialization function of 
the utility programs creates the volume 
label, format 4 label, and format 5 label, 
and reserves space for the format 1 
labels. * 



^-The format 2 and format 3 labels, related 
to indexed-sequential data sets and multi- 
ple extents, respectively, do not apply to 
the Model 4 4 system. 



These labels are created (the header and 
trailer labels as dummy labels) by the 
volume initialization function of the util- 
ity programs. 



Figures 6-10, in the sections following, 
illustrate the format and contents of the 
standard labels supported by the Model 4 4 
Programming System. Facilities are availa- 
ble for creating the full labels, even 
though certain of the fields are not used 
and, therefore, are ignored by the Model 44 
system. 
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VOLUME LABEL FORMAT 
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Figure 6. Volume Label Format 



The volume label (80 bytes) is used for both tape and direct access 
storage volumes. 



Fie ld Name and Length 
1 Label Indentifier, 
3 bytes 



Description 
Contains VOL, 



Volume Label Number, 
1 byte 



Position of this label in a group of 
volume labels. For the Model 4 4 
system, this field must be 1. 



Volume Serial Number, 
6 bytes 



Identification code assigned to this 
volume by the installation. 



Volume Security, 
1 byte 



Security status of a volume; not used 
by the Model 44 system. 



Data Set Directory, 
10 bytes 



On direct access volumes, the address 
of the VTOC; on tapes, recorded as 
blanks. 



6-7 



Reserved, 2 bytes 



Reserved. 



Owner Name and 
Address Code, 
10 bytes 



A specific user, installation, and/or 
system to which the volume belongs. 



Reserved, 29 bytes 



Reserved. 



All reserved fields should be recorded as blanks to facilitate their use 
in the future. The Model 44 system will ignore these fields at the 
present time. 
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FORMAT 1 LABEL 
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Figure 7. Format 1 Label 

format is common to all data sets on direct access storage 



This 
volumes 

Field 



Name and Length 
Data Set Name, 
44 bytes, EBCDIC 



Format Identifier, 
1 byte, EBCDIC 

Data Set Serial Number, 
6 bytes, EBCDIC 



Volume Sequence Number, 
2 bytes, binary 



Description 

Each data set on the volume must have 
a unique name. Names are left- 
justified in the field and the 
remaining bytes are recorded as 
blanks. In the Model 44 system, 
data set names are restricted to 
eight characters. 

1 = Format 1. 



Identifies a data set-volume relation- 
ship; it is identical to the volume 
serial number. 

The order of this volume relative to 
the first on which the data set 
resides. For the Model 44 system, 
this field must be 1. 



Creation Date, 3 bytes. The date on which the data set was 
discontinuous binary created. 
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Field 
6 



7A 



7B 



9 
10 

11 



12 



13 



14 



15 



16 



17 



Name and Leng th 
Expiration Date, 
3 bytes, 
discontinuous binary 

Extent Code, 1 byte 



Bytes used in Last 
Block of Directory, 
1 byte, binary 



System Code, 13 bytes 
Reserved, 7 bytes 
Data Set Type, 2 bytes 

Record Format, 1 byte 



Option Codes, 1 byte 



Block Length, 2 bytes, 
binary 

Record Length, 
2 bytes, binary 

Key Length, 1 byte, 
binary 

Key Location, 
2 bytes, binary 

Data Set Indicators 
1 byte 



Description 

The date on which the data set may be 
deleted. 



The number of extents for this data 
set on this volume. For the Model 
44 system, must be 1. 

Used for directoried data sets. 



Rsssrvsd , 

Identifies the programming system. 

Reserved. 

Identifies the type of data set. Not 
used by the Model 44 system. 

Identifies type of records in the data 
set: record length, track overflow 
(not used by the Model 44 system), 
record blocking, record truncation, 
control character, and record keys. 

One-bit switches indicating options 
used in building data set. Bit 
indicates whether data set was 
created using Write Validity Check. 
Bits 1-7 are reserved. 

Block length used in data set. 
Record length used in data set. 



Length of keys on data records in data 
set. 

High-order position of the embedded 
key in the data record. 

One-bit flags, with the on position 
indicating: 

The last volume on which data set 
resides. For the Model 44, this 
bit is always on. 

1 This data set must always reside 
in the same absolute location on 
the volume. In the Model 44 sys- 
tem, this bit is always off. 

2 The block length must always be a 
multiple of 8 bytes. Not used by 
the Model 4 4 system. 

3 This data set is security- 
protected and requires a password 
for access. Not used by the Model 
44 system. 

4-7 Reserved. 
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Field Name and Length 
18 Secondary Allocation, 
4 bytes, binary 



Description 

Indicates amount of storage to be 
requested for this data set at End 
of Extent. Not used by the Model 4 4 
system. 



19 



Last Record Pointer, 
5 bytes, discontinuous 
binarv 



4- 1~~ 1 = = J- 



x_w uiiti ±qol icuuiu Written in a 
sequential or directoried data set. 



20 



Reserved, 2 bytes 



Reserved. 



Extent Type Indicator, 
1 byte 



Indicates the type of extent. Not 
used by the Model 44 system. 



22 



Extent Sequence Number, 
1 byte, binary 



Indicates the extent sequence in a 
multi-extent data set. For the 
Model 44 system, must be 1. 



23 



Lower Limit, 4 bytes, 
discontinuous binary 



Starting address of this extent compo- 
nent. 



24 



Upper Limit, 4 bytes, 
discontinuous binary 



Ending address of this extent compo- 
nent. 



25-32 Additional Extents, 
20 bytes 



Not used by the Model 44 system. 
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Pointer, 5 bytes, 
discontinuous binary 



Pointer to next data set label within 
this label set. Not used by the 
xModel 44 system. 
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Figure 8. Format 4 Label 
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This format is used to describe the volume table of contents and is 
always the first label in the VTOC. Each volume must have one of these 
labels. 



Field Name and Length 
1 Key Field, 44 bytes, 
binary 



Description 

Each byte contains the hexadecimal 
code 04. 
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Format Identifier, 4 = Format 4, 
1 byte, EBCDIC numeric 



Last Active Format 1, 
5 bytes 



Address of the last active format 1 
label; used to stop a search on a 
data set name. 



Available Data Set The number of unused records in the 

Label Records, 2 bytes, VTOC. 

binary 



Highest Alternate Track, The highest address of a block of 



jytes 



tracks set aside as alternates for 
bad tracks. 



Number of Alternate 
Tracks, 2 bytes, binary 



The number of alternate tracks avail- 
able. 



VTOC Indicators, 
1 byte 



Bit 0, if on, indicates format 5 label 
does reflect true status of volume. 



8A Number of Extents, 
1 byte 



Contains the hexadecimal constant 01 
to indicate one extent in the VTOC. 



8B 



Reserved, 2 bytes 



Reserved, 



Device Constants, 
14 bytes 



Contains constants describing the 
device on which the VTOC was 
created, including device size, 
track length, record overhead, 
flags, tolerance, labels per track, 
and directory blocks per track. 



10 



Reserved, 29 bytes 



Reserved. 



11-14 VTOC Extent, 10 bytes 



The extent of the VTOC; identical in 
format to fields 21-24 of the format 
1 label. 



15 



Reserved, 2 5 bytes 



Reserved. 



FORMAT 5 LABEL 
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Figure 9. Format 5 Labels 



This format is used for direct access storage space management. 



Field 



3-9 



10 



11-2! 



Name and Length 
Key Identification, 

4 bytes 

Available Extent, 

5 bytes 



Available Extents in 
Key, 35 bytes 



Format Identifier, 
1 byte, EBCDIC 

Available Extents, 
90 bytes 



Description 

Each byte contains the hexadecimal 
code 05. 

Indicates an extent available for 
allocation to a data set. The first 
two bytes are relative track 
address; the next two are the number 
of full cylinders in the extent. 
The last is the number of tracks in 
addition to the cylinders. 

These fields, identical to field 2, 
are in relative track address 
sequence. 

5 = Format 5. 



These fields are the same as field 2. 
There are altogether (fields 2-9, 
11-28) 26 extent fields in the for- 
mat 5 label. 



29 



Pointer to Next 
Format 5 



Contains the address of the next for- 
mat 5 label on the volume. 



Appendix. Labels and Label Processing 39 



STANDAR D TAPE DATA SET LABEL 
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Figure 10- Standard Tape Data Set Label (Header and Trailer) 

Tape volumes not having the standard volume label (Figure 7), or 
having the volume label but not the standard tape data set labels 
(Figure 11) are considered to be unlabeled by the Model 44 system. 



Field N ame and Length 
1 Label Identifier, 
3 bytes, EBCDIC 



Data Set Label Number, 
1 byte, EBCDIC 

Data Set Identifier, 
17 bvtes. EBCDIC 



Data Set Serial 
Number, 6 bytes 
EBCDIC 

Volume. Sequence 
Number, 4 bytes 



Description 

HDR = Header Label — beginning of a 
data set 

EOF = End of File — end of a data set 

EOV = End of Volume — end of a volume 
in a multivolume data set- Treated 
as EOF by the Model 4 4 system. 

Always a 1. 



The data set name, left- justified, 
with remaining bytes written as 
blanks. In the Model 44 system, 
data set names are restricted to 
eight characters. 

Identifies a data set-volume relation- 
ship; it is identical to the volume 
serial number. 

Indicates the order of a volume in a 
data set. For the Model 44 system, 
must be 1. 



Data Set Sequence 
Number, 4 bytes 



Generation Number, 
4 bytes 



Assigns numeric sequence to a data set 
on the volume. For the Model 4 4 
system, must be 1. 

Not used by the Model 44 system. 



40 



Field 



11 



12 



13 

14 



Name and Length 
Version Number of 
Generation, 2 bytes 

Creation Date, 6 bytes 

Expiration Date, 
6 bytes 

Data Set Security, 
1 byte 



Block Count, 6 bytes 



System Code, 13 bytes 
Reserved, 7 bytes 



Description 

Not used by the Model 44 system. 



The date the data set was created. 
The date the data set may be deleted- 

Indicates if data set has security 
protection. Not used by the Model 
44 system. 

Used for trailer labels only. Indi- 
cates the number of blocks written 
in the data set from the header 
label to the trailer label, exclu- 
sive of tape marks. 

Identifies the programming system. 

Reserved; should be recorded as 
blanks. 
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GLOSSARY 



absolu te form ; A form of program text 
wherein the instructions have a predeter- 
mined load address and all symbolic address 
references have been replaced with machine 
address values. 



data management : A general term that col- 
lectively describes those functions of the 
system that provide creation of and access 
to data sets, enforce data storage conven- 
tions, and regulate the use of input/output 
devices. 



ab solute loade r: A stand-alone program that 
loads decks in absolute form for execution 
independent of system control. 

allo cate : To reserve external storage space 
for a data set. 



data organization 



A term that refers to 
management conventions for the 

sequential 



the data 

arrangement of a data set, i.e 

and director ied. 



block (records) : 

1. To group records for the purpose of 
conserving storage space or increasing 
the efficiency of access or process- 
ing. 

2. A physical record so constituted. 

catalog : 

1. The data set containing the names and 
volume identifications of selected 
data sets; used by the system to 
locate data sets specified by name 
only. 

2. To include in the catalog the name and 
volume identification of a data set. 



data set : The major unit of data storage 
and retrieval in the system, consisting of 
a collection of data in a prescribed 
arrangement and described by control infor- 
mation to which the system has access. 

data set label : A collection of information 
that describes the attributes of a data set 
and 
set. 



that is normally stored with the data 



device independence : The ability to request 
input/output operations without regard to 
the characteristics of the input/output 
devices. 



cat aloged data set : A data 
represented in the catalog. 



set that is 



communication region : A control block with- 
in the resident supervisor that provides 
for communication between the supervisor 
and a processing program, and among proc- 
essing programs. 

condense: On a direct access volume, to 
shift the data sets, maintaining their 
original sequence, to fill up available 
extents on lower-numbered tracks. In a 
directoried data set, to shift the members 
and, separately, the directory entries, 
maintaining their original sequence, to 
fill up unused space caused by deletion of 
members. After condensing, data sets on a 
volume or members within a directoried data 
set occupy contiguous locations. 

control block : A storage area through which 
a particular type of information required 
for control of the system is communicated 
among its parts. 

control section : The smallest separately 
relocatable unit of a program; that portion 
of text specified by the programmer to be 
an entity, all elements of which are to be 
loaded into contiguous main storage loca- 
tions. 



directoried data set : A data set in direct 
access storage that is organized so that 
the first part contains an index 
(directory) to the members following. 

directory : The initial portion of a direc- 
toried data set that indexes the subsequent 
members by name; it provides the means of 
gaining access to the members. 

dump (main storage) : 

1. To copy the contents of all or part of 
main storage onto an output device, so 
that it can be examined. 

2. The data resulting from 1. 

3. A routine that will accomplish 1. 

entry point : Any location within a module 
to which control can be passed by another 
module. 

extent : The physical locations on a volume 
occupied by or reserved for a particular 
data set. 

fetch (program) : 

1. To obtain a requested phase, load it 
into main storage at the locations 
assigned by the linkage editor, and 
transfer control to the phase entry 
point. 

2. A routine that accomplishes 1. 
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initial program loading (IPL) ; As applied 
to the system, the initialization procedure 
that loads the supervisor and the job 
control processor and begins normal opera- 
tions. 



installation: A general term for a particu- 
lar computing system, in the context of the 
overall function it serves and the indivi- 
duals who manage it, operate it, apply it 
to problems, service it, and use the 
results it produces. 



job: An externally specified unit of work 
for the computing system from the stand- 
point of installation accounting and oper- 
ating system control. A job consists of 
one or more job steps. 

job control processor : The processing pro- 
gram that reads and interprets job control 
statements and sets up the system to exe- 
cute a specific program using specific 
resources. 

job c ontrol statemen t: Any one of the 

control statements in the input stream that 
identifies a job or defines its require- 
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system from the standpoint of the user, 
presented to the system by job control 
statements as a request for execution of a 
specific program and a description of the 
resources required by it. 

library : A collection of objects associated 
with a particular use and having a directo- 
ry to locate individual objects. In this 
context, see module library, phase library. 

linkage : The means by which communication 
is effected between two routines or control 
sections. 

linkage editor : A program that produces one 
or more program phases by transforming 
relocatable modules into a format that is 
acceptable to fetch, combining separately 
produced modules, replacing, deleting, and 
adding control sections as requested, and 
resolving symbolic cross-references among 
them. 



member : An entity within a director ied data 
set, indexed in the data set's directory 
and having data content. 



load : 
1. 



2. 



Generally, to read a phase into main 

storage. 

Program load--to read a phase into 

main storage, and return control to 

the invoking program. 



main storage : All addressable storage from 
which instructions can be executed or from 
which data can be loaded directly into 
registers. 
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single 



execution of the assembler or compiler, in 
relocatable form and consisting of one or 
more control sections with control informa- 
tion to permit relocation and symbolic 
cross-references to other modules. 

module library : A directoried data set 
containing selected modules and serving as 
an automatic source of input to the linkage 
editor. 

multiphase program : A program in absolute 
form that requires more than one fetch or 
load operation to complete execution. 

multiple names : In a directoried data set, 
more than one name entry in the directory 
referring to the same member. 

name : A set of one or more characters that 
identifies a statement, data set, module, 
phase, etc., and that is usually associated 
with the location of that which it iden- 
tifies. 

operator command : A statement to the super- 
visor, iiSUcd Via Lilt; Luilbuie PlixiCfcil.- 

Keyboard, that causes the supervisor to 
provide requested information, alter normal 
operations, terminate a job, etc. 

phase : The unit of output of the linkage 
editor, in absolute form, that is loaded by 
a single program fetch or program load 
operation; may represent an entire program 
or part of a program. 

phase library : The directoried data set 
that contains program phases, processed and 
entered by the linkage editor; the source 
from which program phases are loaded for 
execution. 

problem program : Any of the class of 
routines that perform processing of the 
type for which a computing system is 
intended, and including routines that solve 
problems, perform computations, monitor and 
control industrial processes, etc. 



processing program : A general term for 
program other than the supervisor. 



any 



record : A general term for any unit of data 
that is distinct from all others when 
considered in a particular context. 

relocatable form : A form of program text 
wherein the instructions have variable load 
addresses and symbolic cross-references, 
plus control information to permit later 
conversion to absolute form. 
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relocation: The modification of address 
constants required to compensate for a 
change of origin of a module or control 
section. 

reso urce: Any facility of the computing 
system or operating system required by a 
job and including input/output devices, 
data sets, and processing programs. 

sequential data set : A data set organized 

so that, given one record, the next record 
to be processed is uniquely determined. 

stand-a lone program : Any program that oper- 
ates independently of system control ; gen- 
erally, it is either self-loading or loaded 
by another stand-alone program. 

su p ervisor : As applied to the Model 44 
system, the routines executed in response 
to a requirement for altering or interrupt- 
ing the flow of operations through the 
central processing unit, or for performance 
of input/output operations, and, therefore, 
the medium through which the use of resour- 
ces is coordinated and the flow of opera- 
tions through the central processing unit 
is maintained. 

symbolic data set : In coding a program, the 
designation used to refer to a data set; 
the actual data set whose data content is 
to be processed during a particular execu- 
tion of the program is determined later. 
The later assignment may be an entire data 
set or a specific member of a directoried 
data set. 

symbolic unit : In coding a program, the 
designation used to refer to external stor- 
age; the actual storage to be used during a 
particular execution of the program is 
determined later. 



particular system use and/or content and a 
predefined relationship to a system unit. 



system residence volume : The volume (a 2315 
Disk Cartridge) containing the phase 
library, the catalog, and the IPL routine. 

system support programs : Those processing 
programs that contribute directly to the 
use and control of the system and the 
production of results: the job control 
processor, the linkage editor, and the 
utility programs. 

system unit : A symbolic unit that has a 
particular system use and a predefined 
relationship to a system data set. 

text : The instructions or data content of a 
phase or of the control sections of a 
module, collectively. 

throughput : A measure of system efficiency; 
the rate at which work can be handled by a 
computing system. 

user : Anyone who requires the services of a 
computing system. 

utility programs : A collection of programs 
(together, the utility processor) that per- 
form volume initialization and maintenance 
and data set transmission functions. 

volume : All of that portion of a single 
unit of storage media which is accessible 
via a single read/write mechanism. 

volume identification : The installation's 
designation for a particular tape or direct 
access volume. 



volume table of contents (VTOC) 



table 



sy stem data set : 



data set that has a 



associated with a direct access volume that 
describes each data set on the volume. 
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